POLYGONSHADES <cover> <item | symbol> {lookup_table} {angle_item | angle}
 
shades polygons using item values as shade symbol numbers.
 
arguments
 
<cover> - the coverage containing the polygons to be shaded.  A
<cover> prefixed by a period (.) indicates a map library layer.
 
<item | symbol> - specifies the shade symbol numbers to be used to shade the
polygons.
 
item - an item in the PAT of <cover>.  If no {lookup_table} is given, the
values of the item are used as the shade symbol numbers to shade the polygons.
If a {lookup_table} is given, the values of the item are used as lookup values
to symbol numbers in the {lookup_table}.
 
symbol - a shade symbol number.  This shade symbol will be used to draw all the
polygons.  If the symbol is given as 1000, the current shade symbol will be
used.
 
{lookup_table} - a lookup table that contains the shade symbol numbers will be
used to shade the polygons in <cover>.  Polygons are assigned shade symbols
according to their values for the specified item in the PAT of <cover>.  The
{lookup_table} is a tabular database file that must contain these two items:
 
lookup item - stores values from the specified item in the PAT of <cover>. The
lookup item is named and defined the same as the specified item.
 
SYMBOL - stores the shade symbol numbers used for drawing the polygons for each
value in the lookup item.  SYMBOL must be defined as an ARC-supported numeric
item.
 
{angle_item | angle} - specifies the angle of the shade symbol to be used to
shade the polygons.
 
angle item - an item in the PAT of <cover>.  The values of the item are used to
set the angle at which the current shade symbol will be drawn for each polygon.
 
angle - specifies the angle at which the current shade symbol will be drawn.
 
notes
 
<cover> must have a PAT.
 
If a set of polygons from <cover> has been selected using RESELECT, ASELECT or
NSELECT, POLYGONSHADES will only shade those polygons of <cover> that are in
the selected set.
 
When no {lookup_table} is given, the PAT <item> used to provide symbol numbers
must be a numeric item.  Item values with decimals are truncated to obtain
symbol numbers, so an item value of 14.9 would access symbol number 14.
Polygons with negative values for the item are not drawn.  When a
{lookup_table} is given, the PAT item used to provide lookup values to the
lookup table can be any ARC-supported item type.
 
A pathname can be given with a lookup table.
 
Shade symbol numbers access shade symbol definitions stored in shadeset files.
Shade symbol numbers are integers ranging from 1 to 999.  A shade symbol number
falling outside this range, or for which there is no shade symbol definition,
will not be drawn (e.g., if a shadeset file featuring symbols 1 to 200 has been
specified with the SHADESET command, a shade will not be drawn for a PAT or
lookup table value being used as a symbol number that falls outside the range 1
to 200).
 
A map library must be selected with the LIBRARY command before POLYGONSHADES
can be used with a map library layer.
 
Any numeric item in the coverage's PAT can provide the symbol numbers, or an
item of any type from the PAT can serve as a lookup item to symbol numbers in a
lookup table.
 
There is no limit to the number of vertices in a polygon that can be shaded
with hardware solid-fills (made up of solid color-fill as can be found in
COLOR.SHD) or software solid-fills (made up of very closely spaced hatches as
can be found in the PLOTTER.SHD shadeset file).  If you want to control the
maximum number of vertices per polygon, use the POLYGONSIZELIMIT command.
 
POLYGONSHADES requires up-to-date polygon topology for <cover> (i.e., that
CLEAN or BUILD has been run since the last edit).
